home *** CD-ROM | disk | FTP | other *** search
/ The Mac 12 / the-mac-12.iso / Shareware City / User Interface / ScreenFlip 1.1.1 / ScreenFlip README next >
Encoding:
Text File  |  1995-05-19  |  6.2 KB  |  154 lines  |  [TEXT/ttxt]
  1. _______________________________________________________________
  2. SCREENFLIP 1.1.1  —  A freeware Screensaver Module
  3.  
  4. By Leo Breebaart, Copyright ©1994-95 Kronto Software
  5.  
  6. Internet e-mail: leo@cp.tn.tudelft.nl        
  7. Internet WWW page: http://www.cp.tn.tudelft.nl/leo/kronto.html
  8. _______________________________________________________________
  9.  
  10.  
  11. Description
  12.  
  13.     ScreenFlip performs ‘animated’ horizontal and vertical flips of your
  14.     screen’s contents. Silly, no?
  15.  
  16.  
  17. Features
  18.  
  19.     •  Compatible with After Dark (both 2.0 and 3.0), DarkSide of the Mac and UnderWare.
  20.     •  Flicker-free animation.
  21.     •  Does not use any permanent System memory under After Dark 2.0.
  22.     •  Has an animated About Box and thumbnail.
  23.     •  Runs under both MultiModule and the Randomizer — without crashing.
  24.     •  Comes with extensively documented source code (THINK C 7.0.4 format).
  25.     •  Both the module and the source code are free.
  26.  
  27.  
  28. Restrictions & Technical Remarks
  29.  
  30.     •  ScreenFlip needs Color QuickDraw to run. A color screen is not essential, 
  31.     however: on a Black & White SE/30 the module works just fine.
  32.  
  33.     •  Multiple-monitor setups are supported, but not actively used — the animation
  34.     always runs on the main monitor only (and will simply black out any other screens).
  35.  
  36.     •  ScreenFlip tries to be a well-behaved, system-friendly module. It will,
  37.     for instance, not reserve any permanent memory in your system heap. That
  38.     means that having ScreenFlip selected costs you no more memory than having
  39.     the default ‘Starry Night’ module selected.
  40.  
  41.     •  The ‘Instant Flips’ option uses a lot of (temporary) memory. If the module 
  42.     won’t run because of this, you can try quitting one or two applications.
  43.     Otherwise you can just uncheck the option. There’s no need to restart.
  44.  
  45.     •  I cannot guarantee that ScreenFlip will work with versions of After Dark
  46.     earlier than 2.0u. The same holds for any other programs that are supposed
  47.     to be able to play After Dark modules (except for DarkSide and UnderWare,
  48.     which I had access to). In all such cases, ScreenFlip may run, or it may not.
  49.     Feedback about compatibility issues will be much appreciated.
  50.     
  51.     •  At the moment of writing the latest version numbers of the screensavers
  52.     ScreenFlip has been tested to work with are 3.0b for After Dark, 4.2 for DarkSide
  53.     and 1.0.1 for UnderWare. Free updaters for these programs are readily available
  54.     on the Internet and on all the major commercial software archives. See also the
  55.     URL appendix at the end of this document.
  56.  
  57.  
  58. Version history
  59.  
  60.     1.0        28 Jul 1994
  61.                         —    Initial release.
  62.  
  63.     1.1        24 Feb 1995
  64.                         —    Fixed a bug that made the About Box animation use the same inter flip
  65.                                 delay as the real module, instead of  no delay at all, which was the
  66.                                 intended behaviour.
  67.                         —    The About Box now wil take advantage of After Dark 3.0’s expanded
  68.                                 about box area (provided you’re running 3.0, of course. Duh.).
  69.                         —    Added animated thumbnail for After Dark 3.0.
  70.                         —    Cleaned up the source code.
  71.  
  72. 1.1.1    19 May 1995
  73.                         —    Documentation update. No changes to the actual module.
  74.                         —    Removed all references to the After Dark FTP Site and the Programmers’ List,
  75.                                 because both are now (temporarily) defunct.
  76.     
  77.  
  78. Credits & Acknowledgments
  79.  
  80.     The text shadowing effect in the module’s About Box was created using the
  81.     freeware Adobe Photoshop plug-in filter Drop Shadow, by Alien Skin Software.
  82.  
  83.     As always, thanks to Lloyd “Screensaver FAQ” Wood for feedback and
  84.     beta-testing.
  85.  
  86.     ScreenFlip was created using THINK C 7.0.4,  Think Reference 2.0.1,
  87.     ResEdit 2.1.3, BBEdit 3.1.1, and Adobe Photoshop 2.5.1.
  88.  
  89.  
  90. Known Problems
  91.  
  92.     •    Under certain very rare circumstances (specifically: if you have a
  93.     multi-monitor setup in which your main monitor (the one with the menu
  94.     bar) is not placed in the ‘left-upper-most’ position in the Monitors control
  95.     panel) the module will start drawing garbage on your screen when
  96.     activated. This is an entirely cosmetical bug, and I know precisely what’s
  97.     causing it — I just don’t know how to fix it, yet.
  98.  
  99.     •    Under certain other not-so-rare circumstances (specifically: if After
  100.     Dark starts displaying a “Please Wake Up” message while the module
  101.     is running, e.g. when a background application wants your attention) the
  102.     module will also start drawing garbage to your screen. This too, is an entirely
  103.     cosmetic bug — but I’l be darned if I know what’s causing it, or how to
  104.     fix it.
  105.  
  106.     I would appreciate hearing about any other bugs or problems you may encounter 
  107.     with ScreenFlip.
  108.  
  109. For Programmers
  110.  
  111.     The most recent version of the After Dark programmer’s interface (which
  112.     also gets updated sometimes — the copy that came with your diskette may
  113.     be outdated!) is available from the major Internet archive sites such
  114.     as sumex.stanford.edu, mac.archive.umich.edu and their mirrors. 
  115.  
  116.     You may also want to take a look at The Swarm, another screensaver module
  117.     I wrote, which also comes with documented source code.
  118.  
  119.  
  120. Final Remark    
  121.  
  122.     Nobody who owns a Macintosh screensaver package should be without
  123.     the most recent version of Lloyd Wood’s Screensaver FAQ (Frequently 
  124.     Asked Questions) List. Copies of this list are also available from all major
  125.     archive sites on or off the Internet. It is a must-have. Trust me.
  126.  
  127. Enjoy,
  128.  
  129. __
  130. Leo Breebaart (leo@cp.tn.tudelft.nl)
  131.  
  132. _______________________________________________________________
  133. Appendix: URLs
  134.  
  135.     Here are URLs for the Internet resources mentioned in this document. Newer
  136.     versions of these files may of course have been released by the time
  137.     you read this. Most of the files are available from many other sites as well.
  138.  
  139.     Kronto Software WWW/ftp sites (for info about me and my other programs):
  140.                 http://www.cp.tn.tudelft.nl/L.C.Breebaart/kronto.html
  141.                 ftp://kronto.cp.tn.tudelft.nl/pub/macintosh/
  142.     DarkSide of the Mac 4.2:
  143.                 ftp://ftp.apple.com/dts/mac/hacks/darkside-of-the-mac-4-2.hqx
  144.     Fetch and Anarchie (always the most recent versions):
  145.                 ftp://ftp.tidbits.com/pub/tidbits/select/fetch.sea
  146.                 ftp://ftp.tidbits.com/pub/tidbits/select/anarchie.sea
  147.     Macintosh FAQs WWW/ftp sites:
  148.                 http://www.astro.nwu.edu/lentz/mac/faqs/home-faqs.html
  149.                 http://www.ee.surrey.ac.uk/Personal/L.Wood/screensavers/
  150.                 ftp://rtfm.mit.edu/pub/usenet/news.answers/macintosh
  151.     Drop Shadow 1.1g:
  152.                 ftp://crystal.ualr.edu/mac/info-mac/grf/util/photoshop-drop-shadow-11g.hqx
  153. _______________________________________________________________
  154.